home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Games / mosaic / README < prev    next >
Encoding:
Text File  |  1995-05-03  |  4.5 KB  |  128 lines
  1.                 README file for mosaic, version 1.0
  2.                 Kirk Johnson
  3.                 January 1991
  4.  
  5. NOTE: Renamed mosaic to avoid confusion with NCSA Mosaic, the World Wide Web
  6.       browser. I called it xtile and have changed the source to reflect that.
  7.       However, i left the filenames unchanged.
  8.  
  9. MANIFEST:
  10.  
  11.     README              this file
  12.     Imakefile           for use with "imake"
  13.     Makefile.DIST       for use with "make"
  14.     mosaic.[ch]         non-X-related source code
  15.     x11.[ch]            X-related source code
  16.     mosaic.man          man page
  17.     mosaic.scores       prototype high score file
  18.  
  19.  
  20. INSTALLATION NOTES:
  21.  
  22. Mosaic can be built and installed "by hand", with "make", or with
  23. "imake". Brief instructions for each are provided below. If these
  24. instructions are somehow incorrect or deficient, please send me e-mail
  25. at the address shown below.
  26.  
  27. - To build mosaic "by hand":
  28.  
  29.     (1) Compile the source file "mosaic.c", taking care to provide a
  30.         define for the absolute path of the high score file (see
  31.         "ABOUT THE HIGH SCORE FILE", below).
  32.  
  33.     (2) Compile the source file "x11.c".
  34.  
  35.     (3) Link the resulting object files with the X11 library to
  36.         produce an executable.
  37.  
  38.     (4) Copy the executable and man page to whatever places are
  39.         appropriate for your environment. Copy "mosaic.scores" to path
  40.         you provided in step (1).
  41.  
  42.     (5) Use "chmod a+rwx ..." or "chmod 777 ..." to enable global
  43.         read/write access for the copy of high scores file you made in
  44.         step (4).
  45.  
  46.     On many systems, steps (1) through (3) might be accomplished with
  47.     something like:
  48.  
  49.       cc -DScoreFile=\"/u/tuna/src/mosaic/mosaic.scores\" -c mosaic.c
  50.       cc -c x11.c
  51.       cc -o mosaic mosaic.o x11.o -lX11
  52.  
  53.     (You should replace "/u/tuna/src/mosaic/mosaic.scores" with the
  54.     path you'll be using for the high score file in your system.)
  55.  
  56. - To build mosaic with "make":
  57.  
  58.     (1) Copy the distribution makefile "Makefile.DIST" to "Makefile".
  59.  
  60.     (2) Edit the define for "ScoreFile" as appropriate for your local
  61.         environment. (Replace "/u/tuna/src/mosaic/mosaic.scores" with
  62.         the absolute path you want to use for the high score file; see
  63.         "ABOUT THE HIGH SCORE FILE", below.)
  64.  
  65.     (3) Run "make all" to produce an executable.
  66.  
  67.     (4) Copy the executable and man page to whatever places are
  68.         appropriate for your environment. Copy "mosaic.scores" to path
  69.         you provided in step (1).
  70.  
  71.     (5) Use "chmod a+rwx ..." or "chmod 777 ..." to enable global
  72.         read/write access for the copy of high scores file you made in
  73.         step (4).
  74.  
  75. - To build mosaic with "imake":
  76.  
  77.     (0) I'm not much of an imake wizard, so I don't guarantee that
  78.         the following will work on your system. If you have trouble
  79.         building mosaic according to these directions, you may want to
  80.         resort to using "make" or building "by hand" according to the
  81.         directions given above.
  82.  
  83.         On the other hand, if you _are_ an imake wizard and have
  84.         reasonable suggestions about how I could improve these
  85.         directions and/or the accompanying Imakefile, please send me
  86.         e-mail at the address shown below.
  87.  
  88.     (1) Edit the provided "Imakefile"; replace the definition of
  89.         SCOREDIR with the name of the directory you'd like the high
  90.         score file to be installed in.
  91.  
  92.     (2) Build a Makefile with "xmkmf". (If your system has "imake" but
  93.         not "xmkmf", you might try something like:
  94.  
  95.           imake -DUseInstalled -I/usr/lib/X11/config
  96.  
  97.         Read the "imake" man page or see your local imake wizard for
  98.         more info.)
  99.  
  100.     (3) Run "make all" to produce an executable.
  101.  
  102.     (4) Run "make install" to install the executable and the high
  103.         score file.
  104.  
  105.     (5) Run "make install.man" to install the man page.
  106.  
  107.  
  108. ABOUT THE HIGH SCORE FILE:
  109.  
  110.     Mosaic keeps a list of high scores in a simple text file; all
  111.     users need to have read/write access to this file. You should take
  112.     care not to put the high score file in a place some users will not
  113.     have read/write access to.
  114.  
  115.     After installing mosaic, you may want to double check that other
  116.     users can get at the high score file by having them play a game and
  117.     ensuring that their scores appear in the high score file.
  118.  
  119.  
  120. AUTHOR:
  121.  
  122.     Mosaic was written by Kirk Johnson <tuna@athena.mit.edu>. It is
  123.     based on Joshua Klayman's PC/MS-DOS shareware game of the same
  124.     name. This version is a complete rewrite encompasing only the
  125.     basic functionality of the original.
  126.  
  127.     Bug reports and suggestions are welcome.
  128.